home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat4 / sccsfile.z / sccsfile
Text File  |  1998-10-20  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4. SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))                                                        SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sccsfile - format of SCCS file
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      An SCCS (Source Code Control System) file is an ASCII file.  It consists
  13.      of six logical parts:  the _c_h_e_c_k_s_u_m, the _d_e_l_t_a _t_a_b_l_e (contains
  14.      information about each delta), _u_s_e_r _n_a_m_e_s (contains login names and/or
  15.      numerical group IDs of users who may add deltas), _f_l_a_g_s (contains
  16.      definitions of internal keywords), _c_o_m_m_e_n_t_s (contains arbitrary
  17.      descriptive information about the file), and the _b_o_d_y (contains the
  18.      actual text lines intermixed with control lines).
  19.  
  20.      Throughout an SCCS file there are lines which begin with the AAAASSSSCCCCIIIIIIII SSSSOOOOHHHH
  21.      (start of heading) character (octal 001).  This character is hereafter
  22.      referred to as _t_h_e _c_o_n_t_r_o_l _c_h_a_r_a_c_t_e_r and will be represented graphically
  23.      as @.  Any line described below which is not depicted as beginning with
  24.      the control character is prevented from beginning with the control
  25.      character.
  26.  
  27.      Entries of the form DDDDDDDDDDDDDDDDDDDD represent a five-digit string (a number between
  28.      00000 and 99999).
  29.  
  30.      Each logical part of an SCCS file is described in detail below.
  31.  
  32.      _C_h_e_c_k_s_u_m
  33.           The checksum is the first line of an SCCS file.  The form of the
  34.           line is:
  35.  
  36.                @hhhhDDDDDDDDDDDDDDDDDDDD
  37.  
  38.           The value of the checksum is the sum of all characters, except those
  39.           of the first line.  The @hhhh provides a _m_a_g_i_c _n_u_m_b_e_r of (octal)
  40.           064001.
  41.  
  42.      _D_e_l_t_a _t_a_b_l_e
  43.           The delta table consists of a variable number of entries of the
  44.           form:
  45.                @ssss DDDDDDDDDDDDDDDDDDDD/DDDDDDDDDDDDDDDDDDDD/DDDDDDDDDDDDDDDDDDDD
  46.                @d <type> <SSSSCCCCCCCCSSSS IIIIDDDD> yr/mo/da hr:mi:se <pgmr> DDDDDDDDDDDDDDDDDDDD DDDDDDDDDDDDDDDDDDDD
  47.                @iiii DDDDDDDDDDDDDDDDDDDD ............
  48.                @xxxx DDDDDDDDDDDDDDDDDDDD ............
  49.                @gggg DDDDDDDDDDDDDDDDDDDD ............
  50.                @mmmm <MMMMRRRR number>
  51.                  ....
  52.                  ....
  53.                  ....
  54.                @cccc <comments> ............
  55.                  ....
  56.                  ....
  57.                  ....
  58.                @eeee
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))                                                        SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))
  71.  
  72.  
  73.  
  74.           The first line (@ssss) contains the number of lines
  75.           inserted/deleted/unchanged, respectively.  The second line (@dddd)
  76.           contains the type of the delta (currently, normal: DDDD, and removed:
  77.           RRRR), the SCCS ID of the delta, the date and time of creation of the
  78.           delta, the
  79.           login name corresponding to the real user ID at the time the delta
  80.           was created, and the serial numbers of the delta and its
  81.           predecessor, respectively.
  82.  
  83.           The @iiii, @xxxx, and @gggg lines contain the serial numbers of deltas
  84.           included, excluded, and ignored, respectively.  These lines are
  85.           optional.
  86.  
  87.           The @mmmm lines (optional) each contain one MMMMRRRR number associated with
  88.           the delta; the @cccc lines contain comments associated with the delta.
  89.  
  90.           The @eeee line ends the delta table entry.
  91.  
  92.      _U_s_e_r _n_a_m_e_s
  93.           The list of login names and/or numerical group IDs of users who may
  94.           add deltas to the file, separated by new-lines.  The lines
  95.           containing these login names and/or numerical group IDs are
  96.           surrounded by the bracketing lines @uuuu and @UUUU.  An empty list allows
  97.           anyone to make a delta.  Any line starting with a !!!! prohibits the
  98.           succeeding group or user from making deltas.
  99.  
  100.      _F_l_a_g_s
  101.           Keywords used internally.  [See _a_d_m_i_n(1) for more information on
  102.           their use.]  Each flag line takes the form:
  103.  
  104.                @ffff <flag> <optional text>
  105.  
  106.           The following flags are defined:
  107.                @ffff t <type of program>
  108.                @ffff v <program name>
  109.                @ffff i <keyword string>
  110.                @ffff b
  111.                @ffff m <module name>
  112.                @ffff f <floor>
  113.                @ffff c <ceiling>
  114.                @ffff d <default-sid>
  115.                @ffff n
  116.                @ffff j
  117.                @ffff l <lock-releases>
  118.                @ffff q <user defined>
  119.                @ffff z <reserved for use in interfaces>
  120.  
  121.           The tttt flag defines the replacement for the %%%%YYYY%%%% identification
  122.           keyword.  The vvvv flag controls prompting for MMMMRRRR numbers in addition
  123.           to comments; if the optional text is present it defines an MMMMRRRR number
  124.           validity checking program.  The iiii flag controls the warning/error
  125.           aspect of the ``No id keywords'' message.  When the iiii flag is not
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))                                                        SSSSCCCCCCCCSSSSFFFFIIIILLLLEEEE((((4444))))
  137.  
  138.  
  139.  
  140.           present, this message is only a warning; when the iiii flag is present,
  141.           this message will cause a ``fatal'' error (the file will not be
  142.           gotten, or the delta will not be made).  When the bbbb flag is present
  143.           the ----bbbb keyletter may be used on the _g_e_t command to cause a branch in
  144.           the delta tree.  The mmmm flag defines the first choice for the
  145.           replacement text of the %%%%MMMM%%%% identification keyword.  The ffff flag
  146.           defines the ``floor'' release; the release below which no deltas may
  147.           be added.  The cccc flag defines the ``ceiling'' release; the release
  148.           above which no deltas may be added.  The dddd flag defines the default
  149.           SID to be used when none is specified on a _g_e_t command.  The nnnn flag
  150.           causes _d_e_l_t_a to insert a ``null'' delta (a delta that applies _n_o
  151.           changes) in those releases that are skipped when a delta is made in
  152.           a _n_e_w release (e.g., when delta 5.1 is made after delta 2.7,
  153.           releases 3 and 4 are skipped).  The absence of the nnnn flag causes
  154.           skipped releases to be completely empty.  The jjjj flag causes _g_e_t to
  155.           allow concurrent edits of the same base SID.  The llll flag defines a
  156.           _l_i_s_t of releases that are _l_o_c_k_e_d against editing (_g_e_t(1) with the ----eeee
  157.           keyletter).  The qqqq flag defines the replacement for the %%%%QQQQ%%%%
  158.           identification keyword.  The zzzz flag is used in certain specialized
  159.           interface programs.  _C_o_m_m_e_n_t_s Arbitrary text is surrounded by the
  160.           bracketing lines @tttt and @TTTT.  The comments section typically will
  161.           contain a description of the file's purpose.
  162.  
  163.      _B_o_d_y
  164.           The body consists of text lines and control lines.  Text lines do
  165.           not begin with the control character, control lines do.  There are
  166.           three kinds of control lines:  _i_n_s_e_r_t, _d_e_l_e_t_e, and _e_n_d, represented
  167.           by:
  168.  
  169.                @IIII DDDDDDDDDDDDDDDDDDDD
  170.                @DDDD DDDDDDDDDDDDDDDDDDDD
  171.                @EEEE DDDDDDDDDDDDDDDDDDDD
  172.  
  173.           respectively.  The digit string is the serial number corresponding
  174.           to the delta for the control line.
  175.  
  176. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  177.      admin(1), delta(1), get(1), prs(1).
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.